home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / dviware / vutex / vaxvms.hlp < prev    next >
Text File  |  1990-10-01  |  5KB  |  130 lines
  1. Help File for vutex VMS installations:
  2.  
  3.  
  4. syntax:
  5. !vutex [f1] [f2] [\p1 [,p2]...)]
  6.  
  7.  
  8. purpose:
  9. vutex processor will print a TeX produced dvi file to an ordinary ASCII device
  10.  
  11. f1 - name of an existing dvi file created by TeX.  The string '.dvi' will be
  12.      appended to the end of the input name.
  13.  
  14. f2 - name of a valid ASCII output device.  The string '.vut' will be appended to
  15.      the end of the input name.  If no file name for f2 is entered, output will
  16.      default to SYS$OUTPUT.
  17.  
  18. If neither f2 nor f2 is entered, the user will be prompted for both.  f1 must be
  19. entered at that time, while a null response to the prompt for f2 will default
  20. output to SYS$OUTPUT.
  21.  
  22. p1,p2,... options to control output
  23.  
  24. Options:
  25.  
  26. The available options are given by:
  27.           S or s : for the starting page number
  28.           P or p : for the number of pages, beginning at S
  29.           W or w : for the width of the page in characters before truncation
  30.           T or t : for true TeX spacing as opposed to compressed
  31.           G or g : to initiate processing without further dialog
  32.  
  33.  
  34. If no option is entered, you will be prompted for 4 parameters, all of which may
  35. be defaulted by simply hitting RETURN.
  36.  
  37. For example,
  38.  
  39. $vutex out
  40. This is vutex, DPS8/CP6 Version 0.01
  41. Starting page (default=*): 3
  42. Maximum number of pages (default=1000000): <cr>
  43. Output truncated at column (default=160): 80
  44. Compress interword spacing, Y or N (default=Y): <cr>
  45.  
  46. The first two are identical to those for dvilg8 and dvism, namely starting page
  47. number and number of pages to type.  The third prompt is for the page width in
  48. characters (on most terminals, this is 80; on printers, this is 132).
  49.  
  50. The fourth option allows the user to compress the spacing between words to one
  51. space.  The text for each line will begin in the proper column at the left
  52. margin but all other TeX spacing between words will be reduced to one space.
  53. If the user should not select the compress option, each separate word will be
  54. left justified in the the space provided by TeX, and sup and super scripts will
  55. usually appear on separate lines.  This option is most useful for tables and
  56. mathematical equations.
  57.  
  58.  
  59. Other invocations would include:
  60.  
  61. $vutex \t,w=80
  62. DVI file: test.dvi
  63. VUT file: <cr>
  64.  
  65. or
  66.  
  67. $vutex test junk\w=132,s=4
  68.  
  69.  
  70.  
  71. Seeing TeX output!
  72.  
  73. One of the more frustrating things about TeX and its precise positioning of
  74. characters is that ``what you get is far more than what you can see'' on an
  75. ordinary ASCII terminal.  The only devices for TeX output on the mainframe have
  76. been the laser printers, and that usually equates to running to get ( and
  77. waiting for ) your output, and excessive waste of paper.  Note that at most
  78. installations, laser output is costed at about 10 times that produced by
  79. ordinary hammer printers.
  80.  
  81. So, a program has been written to allow the TeX user to preview the output
  82. before sending it to the laser printer.  Of course, the terminal screen (or an
  83. ordinary printer) still cannot handle the fine spacing of TeX, nor can it
  84. display all the characters you might wish to print.  But, you will see an
  85. approximation to the spacing of words across the line and lines down the page.
  86.  
  87.  
  88. If your output was to a file, such as *vut in the example, you may copy that
  89. file to an ordinary line printer, or you may use a screen editor to view it.
  90. Note the following:
  91.  
  92.      1. Some characters may not appear because they landed in a place already
  93. occupied. Two characters from a small TeX font may fit into the space provided
  94. on the screen, so vutex can only print one such character.
  95.  
  96.      2. The output with true TeX spacing, may be wider than an ordinary screen
  97. of 80 characters, or even a printer page of 132 characters.  With ordinary text
  98. you can compress the text and substantially reduce the width of the page, but
  99. text with lots of off-line text will appear best in true TeX mode.  A screen
  100. editor may be used to view the output by switching from left to right side of
  101. the page.  The present installation limits the width to 160 characters per line.
  102.  
  103.      3. Lines of small type or with extraordinary small interline spacing may
  104. appear superimposed in spaces in the previous line.
  105.  
  106.      4. \special has not been implemented and will be ignored by vutex.
  107.  
  108.      5. If characters are missing from a line because of truncation or
  109. superimposition, then a > sign will appear in the first position of that line.
  110.  
  111.      6. Unprintable characters from ASCII fonts, such as Greek symbols,
  112. and special math symbols, etc. will appear as # marks.  However, as much as
  113. possible, vutex will try to print a meaningful character to suggest what is in
  114. the TeX output  e.g. S is used to replace an integral sign.
  115.  
  116.      7. A + sign in the first position of a line means that it contains super
  117. scripts to the next line down, while a - sign means that it contains sub
  118. scripts to the previous line up.
  119.  
  120.      8. At the end of each TeX page, a ruler is drawn (in centimeters) to
  121. indicate the horizontal scale (this will not appear on the TeX output to a
  122. printer).  Usually the vertical scale is only an approximation of the true TeX
  123. spacing, and some pages may appear physically shorter than others.  If it is
  124. desired that all pages be the same length, perhaps with a form feed, this
  125. alteration can be made to the code.
  126.  
  127.  
  128. Note:  In the examples given above, it is assumed that a suitable CLD file has
  129.        been implemented.  (See vutex.cld on the program disk)
  130.